home *** CD-ROM | disk | FTP | other *** search
/ Aminet 3 / Aminet 3 - July 1994.iso / Aminet / util / cli / MagicClip.lha / MAGICCLIP / MagicClip.doc < prev    next >
Encoding:
Text File  |  1993-11-03  |  2.6 KB  |  87 lines
  1.  
  2.   ----------------------------------------------------------------
  3.   MagicClip 1.2 (5.8.93) © Franz.Schwarz@mil.ka.sub.org - Freeware
  4.   ----------------------------------------------------------------
  5.   
  6. MagicClip is a shell utility for Amiga-OS2.04 or above.  It provides
  7. you with the ability to read text from or write text to any clipboard
  8. unit.
  9.  
  10. The command line argument stencil is
  11.  
  12.                     "UNIT/K/N,GET/S,FILE/K,PUT/F"
  13.                        
  14.  
  15. The following are the arguments' meanings:
  16.  
  17.  
  18. UNIT/K/N - the number of the clipboard unit you want to operate on.
  19.   Valid are numbers within the range 0..255. Default is unit 0.
  20.  
  21. GET/S - This switch enables the read operation mode.  MagicClip tries
  22. to gather text information from the selected clipboard unit and
  23. writes it to the standard output chanel.  If the accessed clipbard
  24. unit is still empty or if no text data was found in it, MagicClip
  25. returns Dos.warn (5).
  26.  
  27. FILE/K - This argument causes MagicClip to dump the contents of the
  28. specified file to the selected clipboard unit as text.
  29.  
  30. PUT/F - This argument instructs MagicClip to write the contents of the
  31. rest of the command line to the selected clipboard unit as text.
  32.  
  33. You may and must always specify exactly one of the GET/S, FILE/K and
  34. PUT/F arguments, of course.
  35.  
  36.  
  37. Whenever MagicClip fails due to any reason, it returns Dos.fail (20)
  38. and reports the failure to stdout.
  39.  
  40.  
  41. You can control MagicClip's output in the read operation mode with
  42. two environment variables:
  43.  
  44.   MAGICCLIPCHUNKSEP may hold the text that is printed as a chunk separator
  45.   between two printed IFF chunks. Default is a single linefeed (0x0a)
  46.   character.
  47.   
  48.   MAGICCLIPENDTXT may hold the text that is printed right after the end 
  49.   of all clipboard text. Default is an empty string.
  50.  
  51.  
  52.  
  53. Implementation details:  MagicClip makes heavily use of iffparse.library.
  54. The enclosed source code may serve as an example for using
  55. iffparse.library.
  56.  
  57.  
  58.  
  59. Since MagicClip is pure and brief, yet powerful, it's highly
  60. recommened that you make MagicClip resident.
  61.  
  62.  
  63. MagicClip is Freeware, i.e., it's freely distributable _and_ the
  64. author holds the copyright on it.  A word about the author's
  65. liability:  it does not exist at all in any way whatsoever.  You use
  66. this software definitively at your own risk.
  67.  
  68.  
  69.  
  70.  
  71.           MagicClip written and copyrighted, © 1993 by 
  72.     Franz Schwarz, Mühlenstraße 2, D-78591 Durchhausen, Germany.
  73.        uucp: Franz.Schwarz@mil.ka.sub.org; Fido: 2:241/7506.18
  74.  
  75.  
  76. Suggestions, criticism, flames, money, gold, disks, beer, chocolate,
  77. nice postcards, e-mails, etc.  are welcomed and appreciated!;-)
  78.  
  79.  
  80.  
  81.     Bye
  82.       Franz 'Blacky' Schwarz
  83.  
  84.  
  85.                -Girlfriend Is Better - Talking Heads-
  86.  
  87.